Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

WG and TF updates #1018

Open
wants to merge 165 commits into
base: main
Choose a base branch
from
Open

WG and TF updates #1018

wants to merge 165 commits into from

Conversation

iadawn
Copy link
Contributor

@iadawn iadawn commented Dec 13, 2024

Copy link

netlify bot commented Dec 13, 2024

Deploy Preview for wai-website ready!

Name Link
🔨 Latest commit bccfd21
🔍 Latest deploy log https://app.netlify.com/sites/wai-website/deploys/67a1b75f82cf0f00080dfb15
😎 Deploy Preview https://deploy-preview-1018--wai-website.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 98 (🟢 up 10 from production)
Accessibility: 100 (no change from production)
Best Practices: 92 (no change from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify site configuration.

- abbreviations (expanding some)
- simplify summary sentence (without removing or changing meaning) and format as a list for readability
- add section with quick link to Admin home page
- remove generic headings
- add headings / structure content meaningfully under headings that match key words in the information
- make headings sentence case
- remove capital letters from nouns that are not proper nouns
- Make link text slightly more descriptive, including signaling if moving away from WAI to a different sub-site.
- Add / correct URLs
- remove passive tense
- use plain language
- make sentences more concise
- make list items consist of only one sentence per item (best practice)
- fix typos
Copy link
Contributor Author

@iadawn iadawn left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @tamsinewing555,

Thanks for this. I like your alternative approach that avoids lots of headings with a single link. Thanks for taking the time to come up with a solution to my concerns!

There are a few wee things that are slightly off. I have put comments into the PR - ping me if you are unable to find them.

pages/about/groups/agwg.md Outdated Show resolved Hide resolved
pages/about/groups/agwg.md Outdated Show resolved Hide resolved
pages/about/groups/agwg.md Outdated Show resolved Hide resolved
pages/about/groups/agwg.md Outdated Show resolved Hide resolved
pages/about/groups/agwg.md Show resolved Hide resolved
pages/about/groups/agwg.md Outdated Show resolved Hide resolved
pages/about/groups/agwg.md Show resolved Hide resolved
Copy link
Contributor Author

@iadawn iadawn left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tamsinewing555

Looking good. I think only one comment left on AG WG. ACT TF has a couple of minor things.

pages/about/groups/task-forces/conformance-testing.md Outdated Show resolved Hide resolved
pages/about/groups/task-forces/conformance-testing.md Outdated Show resolved Hide resolved
pages/about/groups/task-forces/conformance-testing.md Outdated Show resolved Hide resolved
pages/about/groups/task-forces/conformance-testing.md Outdated Show resolved Hide resolved
Copy link
Contributor Author

@iadawn iadawn left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Couple of points about wee bits I missed.

pages/about/groups/agwg.md Outdated Show resolved Hide resolved
pages/about/groups/agwg.md Outdated Show resolved Hide resolved
@iadawn
Copy link
Contributor Author

iadawn commented Feb 6, 2025

@shawna-slh, @remibetin The new structure that we have includes exposing TF Work Statements in the left hand navigation. This results in a forth level of sidebar navigation which looks like:

sidebar nav showing forth level of depth

Thoughts?

We have had this problem before with How People with Disabilities Use the Web but got round it by rejigging the approach slightly. For the case of TF Work Statements I am not sure there is an easy alternative - I did think of pulling TFs to the same level as Groups but I don't think that is appropriate.

@remibetin
Copy link
Member

remibetin commented Feb 7, 2025

@iadawn

For the case of TF Work Statements I am not sure there is an easy alternative - I did think of pulling TFs to the same level as Groups but I don't think that is appropriate.

I also think it's hard to find an easy alternative.

The current hierarchy is probably deep, but I think it is clear.
"About W3C WAI > Groups > Task forces > Accessibility Conformance Testing TF > Work statement" makes logical sense and follows a clear hierarchy.

I am more concerned by the missing secondary navigation and breadcrumbs in the current work statements pages in that regard. On these pages, users have no clues about where they are and where to go next. See for example: https://www.w3.org/WAI/about/groups/task-forces/conformance-testing/work-statement/

The way the menus are designed is another thing. We could probably improve that: the indentation becomes more and more important in the secondary navigation when we go deep. Although finding the right consistent approach would require substantial effort. A possibility among others: W3C main site is using a mega menu, and section navigation.

For the moment, I would keep your proposed structure and make sure the breadcrumbs and secondary navigation are indeed displayed on fourth level pages.

@remibetin
Copy link
Member

remibetin commented Feb 7, 2025

Another thought: I am not sure finding a Task force work statement is a top task for most users of the WAI website. I would imagine people looking for a task force work statement would even prefer to browse the "Discover W3C groups" section of the W3C website and find the work statement of any W3C task force/group?

In this page for example: https://www.w3.org/groups/tf/wcag-act/

@iadawn
Copy link
Contributor Author

iadawn commented Feb 7, 2025

Another thought: I am not sure finding a Task force work statement is a top task for most users of the WAI website. I would imagine people looking for a task force work statement would even prefer to browse the "Discover W3C groups" section of the W3C website and find the work statement of any W3C task force/group?

Work statements aren't really a required feature of Task Forces. Based on that it probably wouldn't be appropriate to request this change to the core Group pages.

@iadawn
Copy link
Contributor Author

iadawn commented Feb 7, 2025

For the moment, I would keep your proposed structure and make sure the breadcrumbs and secondary navigation are indeed displayed on fourth level pages.

There will be a couple of PRs to deal with this: one in wai-website-theme to handle the changes to the sidenav and one in the wai-website-data to handle the new navigation.yml. As well as this one.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

8 participants